Delphi 6 Installation Notes ============================================================ This file describes issues that may affect the installation of this product. We recommend that you read it in full before continuing. The contents of this file are available on your CD for later printing or viewing. Other notes, including known issues, compatibility information, and uninstallation information, are contained in the product README file, also available for review or printing after installation from your CD or from your installation directory root. ============================================================ CONTENTS * ABOUT THE NEW INSTALLER * INSTALLING FOR MULTIPLE USERS [WINNT/2000 ONLY] * GENERAL INSTALLATION NOTES * KNOWN INSTALLATION ISSUES * REGISTERING THIS PRODUCT * UNINSTALLING THIS PRODUCT ============================================================ ABOUT THE NEW INSTALLER This product now uses the new Microsoft Installer (MSI) service to perform the installation. Among the more significant changes are: * In many cases, rebooting after installation is no longer necessary. The Borland Debugger kernel and other Borland components are automatically registered during installation. However, the installer may update some Windows system components, which will require you to reboot at the end of the installation. In addition, if you are installing on Windows 95/98 or Windows Millennium, you may wish to reboot to have your PATH environment updated. * An installation maintenance mode is available by simply rerunning the installation. The maintenance dialog lets you add or remove features, repair the installation, or remove the product. Choosing "Modify" lets you install features that you did not previously install, or remove features that you no longer use. Choosing "Repair" causes the installer to search for and reinstall any files that are missing or damaged. "Remove" uninstalls the product. * On Windows 2000 and higher (including Windows XP), the Microsoft Installer service provides an auto-repair feature that constantly tries to detect and repair damaged applications. One of the ways that it does this is by monitoring the installed directory structure of an application. If you delete or rename any of the directories installed by Delphi, the Microsoft Installer will detect this and will, without warning, attempt to restore the missing directories. To prevent the auto- repair function from being unintentionally invoked, you should not manually delete or rename any of the installed Delphi directories. To add or remove features, always use the installer application. ============================================================ INSTALLING FOR MULTIPLE USERS [WINNT/2000 ONLY] [Note: This section applied only to installations on Windows NT, 2000, and later Windows operating systems, including XP. It does not apply to installations on Windows 95, 98, or Millennium systems.] The procedure for installing and uninstalling Delphi for multiple users on Windows NT and Windows 2000 systems has changed. The new installation procedure no longer requires each user to install Delphi separately. The product is installed only once, by any user with Administrator privileges, and is immediately available to all users of the same machine. It is also available to any new users you may add later. In previous releases, an Administrator installed the product, and all other users of the same machine who needed to use Delphi had to install the product separately using the "Registry Only" option. The new uninstallation procedure has also changed. The Administrator who initially installed the product must first uninstall it (through the Control Panel's Add/Remove Programs applet); after that, all other users of the product must log in and run the provided D6RegClean.exe utility in order to remove user-specific data from the Windows registry. (Note: D6RegClean.exe is installed to your \Bin directory and is also available on your CD in the \Info\Extras folder.) In previous releases, no uninstall mechanism was provided for users other than the Administrator who installed the product. Cautions ------------------------------ * Some utilities--such as the Image Editor, the Package Collection Editor, Database Desktop, and the XMLMapper-- will not work correctly until the Delphi IDE is run at least once. This is because the IDE copies a set of global registry entries from HKEY_LOCAL_MACHINE to the user's registry space. In the past, the installation program performed this task. * If you perform a partial install, then add other components later, the new components will not automatically appear in the IDE. To make the new packages appear, you can manually add them to the IDE using the Install Packages dialog (Component menu). An alternative is to run the D6RegClean.exe utility to force the IDE to refresh its settings from the global environment space. Note: Using the latter procedure will restore the default settings, replacing any customized settings you may have made. ============================================================ GENERAL INSTALLATION NOTES The following items describe known issues, behavior, and functionality that can affect installation of this product. For other installation issues, including how to remove the product, see the INSTALL document at the root of your CD. Minimum system requirements ------------------------------ * Intel Pentium 166 MHz or higher (P2 400 MHz recommended) * Microsoft Windows 98, 2000, Me, NT 4.0 with Service Pack 5 or later * 64 Mb RAM (128 Mb recommended) * 115 Mb hard disk space (compact install) * 350 Mb hard disk space (full install) * CD-ROM drive * VGA or higher resolution monitor * Mouse or other pointing device Before you install ------------------------------ You should always protect your data by backing it up. Before loading a project that was created with an earlier version of this product, be sure that copies of all of the files related to the project you're about to load are backed up and securely stored. Back up your BDE configuration ------------------------------ This product includes a new version of the Borland Database Engine (BDE). Unless you specify other than the default setup directories during installation, Delphi will overwrite your existing 32-bit BDE and SQL Links installations, so it is strongly recommended that you back up all current BDE configuration files before installing this release. Installation directory ------------------------------ By default, this release installs into the directory \Program Files\Borland\Delphi6 Product release notes and most other documentation assumes these defaults. WARNING: Do not install Delphi 6 in a directory that contains an older version. Always install a new version of Delphi in a new directory. Different versions of Delphi can coexist on the same system, but each version must be installed in its own directory. If you've installed this product before ------------------------------ You can install to the same machine (though to a different location) as another version of the product. If you want to install to the same directory as an existing version, uninstall the existing version first. In either case, you should back up your IDAPI.CFG file (if one is present) and any other important data, including existing projects that you intend to use with this version. Uninstall Internet Control Pack ------------------------------ If you have installed any previous release of the Microsoft Internet Control Pack, uninstall that version before installing this product. Installing from a network or shared drive ------------------------------ If installing from a network or shared drive, you must map a drive letter to the server and folder that contains the INSTALL.EXE program that initiates installation of this product. Performing a Custom installation ------------------------------ To conserve disk space, you can perform a custom installation, selecting only the options you require. To do so, select the Custom radio button in the Setup Type dialog during installation. Disk space required for the total custom installation and individual options is displayed as you select or deselect options. Avoiding a VisiBroker version conflict ------------------------------ During installation you are asked which type of CORBA support you want installed: either the VisiBroker 3.3/CORBA DII solution or VisiBroker 4/CORBA IDL2Pas solution (or no CORBA at all). Note: If you choose VisiBroker 4, the installer looks for Sun's Java Runtime Environment (JRE) or Java Development Kit (JDK) version 1.2.2 or higher. If neither is found, JRE 1.2.2 is installed. Just-In-Time Debugging ------------------------------ If the installer detects that another application is registered as your Just-In-Time debugger, you will be asked if you want to change this setting to use the Delphi debugger. For proper operation of this release, you should choose to update this setting. To preserve your existing AEDebug settings for later restoration, follow these steps: 1. Run Regedit. 2. Select the AEDebug key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ Windows NT\CurrentVersion\AEDebug\Debugger 3. Choose Registry|Export Registry File. 4. Name and save the file containing the AEDebug key. To restore the AEDebug settings: 1. Run Regedit. 2. Choose Registry|Import Registry File. 3. Specify the file in which you saved the AEDebug key. Manually registering the debugger kernel ------------------------------ The new installer does not, in most cases, require you to reboot after installation. The Borland Debugger Kernel is automatically registered by the new installer. If, however, you receive "BORDBK60 not registered" errors when running the program, then you will need to manually register the debugger. To manually register the debugger, open a command window, switch to the Debugger Kernel location (default c:\program files\common files\borland shared\debugger\bordbk60.dll) and run the Microsoft Register Server utility with the following command: regsvr32 bordbk60.dll Note: If REGSVR32 is not on your path, switch to your Windows/System directory and run the utility with a full path specification to the Debugger Kernel file. Legacy Windows libraries ------------------------------ In past releases of this product, updated versions of some Microsoft Windows DLLs were installed for you. These included OLEAUT32.DLL, OLEPRO32.DLL, MSVCRT.DLL, MSVCRT20.DLL, and MSVCRT40.DLL. We updated these libraries because Windows 95 systems required the updates in order to run provided demos and examples. However, we are no longer checking for and updating these libraries, since the versions provided by current Windows versions (2000, 98 and higher, and NT 4.0 Service Pack 5 and higher) support the demos we provide. For Windows 95 users and anyone else who may need them, the library updates will instead be available for copying from the installation CD. The files are located in the directory /Info/Extras/Win95Support. Installer may require additional temporary space ------------------------------ If the drive containing the folder specified in your TMP environment variable is low on space, the Installer may halt with an error message noting the shortage. If this occurs, you'll need to assign your TMP variable to a folder on a drive with more disk space, then rerun the installation. ============================================================ KNOWN INSTALLATION ISSUES JRE, InterBase paths require manual entry ------------------------------ Neither the VisiBroker 4 or Java Runtime Environment (JRE) installers set your PATH or CLASSPATH specifications to point to the JRE installation location. Unless you manually set these environment variables, programs requiring the JRE (including all VisiBroker programs except the OSAgent and the console, which uses a batch file) will not run. The InterBase Administration components IBInstall and IBUninstall will not work correctly unless you manually add the \Bin location to your PATH variable. Installer may misreport disk space requirements on Windows 95/98/ME ------------------------------ On Windows 95, 98, and Millennium systems, the Microsoft Windows Installer may misreport the amount of disk space required by Delphi. The Installer may report that it needs more than 2GB of disk space. Delphi does not require this much space. To work around this issue, exit the Installer and restart the installation. VisiBroker install dialog displays incorrect information ------------------------------ The VisiBroker 4.1 installer displays a dialog which suggests an evaluation version is being installed. You may disregard this information. A "Named User" development license, as described in the VisiBroker license agreement, will be provided by the Delphi installer. JRE error message on Japanese Windows systems ------------------------------ On Japanese Windows systems, Sun's JRE installer issues the following error message: "JRE_UPDATE_VERSION entry not found in the string table." The message may be ignored; installation of the JRE is not affected, and you may safely continue the installation by pressing the OK button in the error dialog. ============================================================ REGISTERING THIS PRODUCT Registration is required of all users. The Registration dialog appears on first use of the product. If you choose not to register on first use, you can run the Registration application any time thereafter by selecting Start|Programs|Borland Delphi 6|Register Now, or running the program D6reg.exe from your Delphi6\Bin folder. The Registration program offers three ways to register: Online (direct registration through a secure connection), by telephone, or through a Web form. If you choose to receive your activation key over the phone or via email through the Web form, the unregistered product will remain fully functional until you enter your activation key in the appropriate field in the Registration dialog. Each of the Registration options is driven by Wizards, with Help provided where necessary. IMPORTANT Online registration requires an active Internet connection. The process uses port 443 for the transaction; if there is a problem using that port, an attempt is made through port 8080. If your machine is protected by a firewall and the process fails, you must either contact your system administrator to request that the ports noted above be made available, or use an alternate registration method, such as telephone or Web registration. Online registration also requires that all users of this copy of the software use the same software registration account when registering. ============================================================ UNINSTALLING THIS PRODUCT To uninstall this release from your computer, open the Control Panel folder and double-click the Add/Remove Programs icon. Select Borland Delphi 6 from the list, click the Add/Remove button, and follow the instructions that appear on the screen. Notes: * During installation you're asked if you want to save a copy of the installation database to your hard disk drive. Doing so will allow you to uninstall without inserting the product CD. However, if the local copy of the installation database becomes damaged or is erased, the CD may be required to uninstall the product. The installation database ("Borland Delphi 6.msi") can be found in the Install directory on your CD. * Delphi 6 and other dbExpress-based applications use the registry key HKEY_CURRENT_USER\Software\Borland\DBExpress to locate the database configuration files (dbxconnections.ini and dbxdrivers.ini). When uninstalling Delphi 6, you are asked if you want to remove the dbExpress registry keys. If you know that you are not using any other dbExpress-based applications, you can answer Yes. If other dbExpress applications exists on your computer, you should answer No. If you do not delete the dbExpress registry entries and you later reinstall Delphi to a different location, you will need to manually delete this registry key for dbExpress to recognize your new configuration file location. ============================================================ Copyright © 2001 Borland Software Corporation. All rights reserved.